.\"
.\" Copyright (c) 2006-2017 Apple Inc. All rights reserved.
.\"
.\" Licensed under the Apache License, Version 2.0 (the "License");
.\" you may not use this file except in compliance with the License.
.\" You may obtain a copy of the License at
.\"
.\"     http://www.apache.org/licenses/LICENSE-2.0
.\"
.\" Unless required by applicable law or agreed to in writing, software
.\" distributed under the License is distributed on an "AS IS" BASIS,
.\" WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
.\" See the License for the specific language governing permissions and
.\" limitations under the License.
.\"
.\" The following requests are required for all man pages.
.Dd November 6, 2008
.Dt CALDAVD 8
.Os
.Sh NAME
.Nm caldavd
.Nd Calendar Server Control Interface
.Sh SYNOPSIS
.Nm
.Op Fl hX 
.Op Fl hL 
.Op Fl u Ar username
.Op Fl g Ar groupname
.Op Fl T Ar twistd
.Op Fl f Ar caldavd.plist
.Sh DESCRIPTION
.Nm
is a front end to the Calendar Server.  Calendar Server is provides a
calendaring service based on the CalDAV protocol, which is in turn
based on HTTP and WebDAV.
.Pp
.Nm
is a simple tool for starting the server.
.Sh OPTIONS
.Bl -tag -width flag
.It Fl h
Displays usage information
.It Fl X
Starts the server but does not daemonize it.
.It Fl L
Sends error logging output to stdout rather than the file specified in
caldavd.plist.
.It Fl u Ar username
Drops privileges to the given username.
.It Fl g Ar groupname
Drops privileges to the given groupname.
.It Fl f Ar caldavd.plist
Specifies the path of the configuration file to read.
.It Fl T Ar twistd
Specifies the path to the twistd binary.
.El
.Sh FILES
.Bl -tag -width flag
.It /etc/caldavd/caldavd.plist
The Calendar Server configuration file.  It is an XML property list
specifying server options such as the port to bind to, whether to use
SSL, and the names of other files can specified.
.It /etc/caldavd/server.pem
PEM-format server keys for use with SSL.
.It /var/log/caldavd/access.log
The server's access log file, in a format similar to Apache HTTPd's
access log.
.It /var/log/caldavd/error.log
The server's main log file.
.It /var/run/caldavd.pid
The server's process ID file.
.El
.Sh SEE ALSO
.Xr httpd 8
.Sh STANDARDS
Calendar Server is intended to comply with RFC 2445 (iCalendar), RFC
2446 (iTIP), RFC 2447 (iMIP), RFC 2612 (HTTP), RFC 2617 (HTTP
Authentication), RFC 4559 (SPNEGO), RFC 2518 (WebDAV), RFC 3744
(WebDAV ACL), RFC 5397 (WebDAV Current Principal Extension), RFC 4791
(CalDAV), and draft-desruisseaux-caldav-sched-06 (CalDAV Scheduling).
.Sh HISTORY
.Nm
was first introduced as part of Mac OS X Server 10.5.
